You are a senior frontend architect and senior Next.js engineer.

I want you to build a production-ready Web App frontend for a Coupons / Discounts / Cashback platform.

Important:
The visual style and user experience should be inspired by modern Arabic coupon websites similar in structure to Sahseh, but do NOT copy it literally.
Create a unique, clean, premium, responsive design with the same business idea and similar page organization, while keeping original implementation and reusable components.

Project context:
- The Laravel backend and REST APIs are already completed
- The backend serves:
  1. Web App
  2. React Native mobile apps
  3. Admin dashboard
- I am now starting the customer-facing Web App
- This Web App should be responsive for desktop, tablet, and mobile browsers
- Primary language is Arabic with RTL support
- English support should also be prepared
- The app is for coupons, discount codes, cashback offers, stores, categories, favorites, and user accounts

==================================================
MAIN DESIGN DIRECTION
==================================================

Build a user-facing website with a premium modern Arabic e-commerce savings style.

Design inspiration direction:
- Hero section with promotional banners
- Strong search experience for stores and coupons
- Featured stores
- Featured coupons
- Cashback offers
- Categories section
- Clean coupon cards
- Store detail pages
- Coupon detail pages
- User account pages
- Favorites
- Static pages like FAQ / Terms / Privacy / Contact

Do NOT clone any existing website exactly.
Instead, create an original design system with:
- strong RTL layout
- modern card-based UI
- high readability
- professional Arabic typography-friendly spacing
- clear CTA buttons
- responsive layouts
- elegant color palette suitable for discounts/cashback platforms

==================================================
TECH STACK REQUIREMENTS
==================================================

- Next.js latest stable version
- TypeScript
- App Router
- Tailwind CSS
- Axios
- TanStack React Query
- React Hook Form
- Zod
- Clean reusable component architecture
- Scalable folder structure
- SEO-friendly public pages
- Dynamic routing where needed

==================================================
WEB APP PAGES REQUIRED
==================================================

Build the Web App with these pages:

1. Home Page
Must include:
- top header
- navigation menu
- search bar
- hero banners
- featured categories
- featured stores
- most used coupons
- latest coupons
- cashback stores
- footer

2. Stores Listing Page
- list all stores
- search
- category filter
- sorting
- pagination

3. Store Details Page
- store logo
- store cover/banner if available
- store name
- store description
- cashback info
- favorite button
- share button
- store coupons list
- store cashback offers

4. Coupons Listing Page
- all coupons
- highest discount coupons
- recently added coupons
- filtering
- search
- pagination

5. Coupon Details Page
- store info
- coupon title
- coupon code
- discount value
- coupon type
- description
- terms or notes
- copy coupon button
- go to store button

6. Cashback Page
- cashback stores list
- cashback offers
- filters
- pagination

7. Categories Page
- all categories
- category cards
- link to category-specific stores/coupons

8. Search Results Page
- global search results for stores and coupons

9. Favorites Page
- favorite stores
- favorite coupons
- authenticated users only

10. User Account Pages
- login
- register
- forgot password
- profile
- preferred language
- preferred country

11. Notifications Page
- authenticated users only

12. Static Pages
- FAQ
- Terms
- Privacy
- Contact Us
- About Us if useful

==================================================
DESIGN SYSTEM REQUIREMENTS
==================================================

Create a full original design system including:

- color palette
- typography scale
- spacing system
- border radius system
- shadows
- button variants
- input styles
- badge styles
- card styles
- section spacing
- empty states
- loading states
- error states

Suggested visual direction:
- clean white background
- accent colors suitable for offers/cashback
- clear visual hierarchy
- rounded modern cards
- subtle shadows
- colored status badges like:
  - Verified
  - Cashback
  - Featured
  - New

==================================================
CORE UI COMPONENTS
==================================================

Build reusable components such as:

- Header
- Navbar
- Mobile menu
- SearchBar
- HeroBannerSlider
- CategoryCard
- StoreCard
- CouponCard
- CashbackCard
- FilterBar
- SortDropdown
- Pagination
- FavoriteButton
- CopyCouponButton
- ShareButton
- SectionHeader
- Footer
- EmptyState
- Loader / Skeleton
- AuthForm components

==================================================
API INTEGRATION REQUIREMENTS
==================================================

Integrate with the existing Laravel APIs.

Use a clean service layer for endpoints such as:
- /home
- /categories
- /stores
- /stores/{id}
- /stores/{id}/coupons
- /stores/{id}/cashback
- /coupons
- /coupons/{id}
- /coupons/{id}/copy
- /coupons/{id}/click
- /cashback/stores
- /cashback/offers
- /favorites
- /favorites/toggle
- /notifications
- /pages/{key}
- /auth/*
- /profile

Create:
- centralized API client
- query hooks
- mutation hooks
- auth handling
- token storage strategy for web
- protected routes for account/favorites/notifications

==================================================
SEO REQUIREMENTS
==================================================

The public website must be SEO-friendly.

Implement:
- metadata per page
- dynamic meta for store and coupon pages
- semantic headings
- descriptive titles
- clean URL structure
- SSR/ISR-friendly public pages where practical

Suggested routes:
- /
- /stores
- /stores/[slug]
- /coupons
- /coupons/[id]
- /cashback
- /categories
- /categories/[slug]
- /favorites
- /account
- /login
- /register
- /notifications
- /pages/[key]

==================================================
RTL / LOCALIZATION REQUIREMENTS
==================================================

Support:
- Arabic RTL
- English LTR
- reusable localization-ready text structure
- layout direction handling
- future i18n support even if Arabic is the main starting language

==================================================
AUTH UX REQUIREMENTS
==================================================

- login modal or page (choose the cleaner UX)
- register page
- forgot password page
- protected pages redirect unauthenticated users
- favorite action should request login if guest
- account dropdown/menu when authenticated

==================================================
OUTPUT REQUIREMENTS
==================================================

Generate the project in this exact order:

1. High-level architecture overview
2. Folder structure
3. Install commands
4. Project setup files
5. Tailwind and global theme setup
6. Design system foundations
7. Shared UI components
8. API client and service layer
9. Query hooks
10. Layout and navigation
11. Home page
12. Stores pages
13. Coupons pages
14. Cashback pages
15. Auth pages
16. Favorites and notifications pages
17. Static pages
18. Final integration notes

For every step:
- mention exact file paths
- provide complete runnable code
- include imports
- do not leave placeholders
- do not skip required files

==================================================
IMPORTANT QUALITY RULES
==================================================

- Build clean, scalable, production-ready code
- Keep component naming professional
- Use feature-based or hybrid structure cleanly
- Avoid duplicated code
- Create reusable cards and sections
- Keep the UI premium and polished
- Do not copy any brand assets or exact layouts from other websites
- Build an original design inspired by the coupons/cashback business model
- Make the result look like a real launch-ready product

==================================================
FINAL GOAL
==================================================

At the end, I want a full customer-facing Web App that:
- looks premium
- feels similar in business flow to top coupon platforms
- is fully responsive
- is connected to my Laravel APIs
- is ready for further development and testing

Start now with:
1. architecture overview
2. folder structure
3. install commands
4. base project setup